home *** CD-ROM | disk | FTP | other *** search
/ So Much Shareware 3 / So Much Shareware 3 (Power User Software).ISO / utils / arj239.exe / UPDATE.DOC < prev    next >
Text File  |  1992-11-22  |  11KB  |  330 lines
  1.  
  2.      UPDATE.DOC, ARJ 2.39b                                  November 1992
  3.  
  4.  
  5.      This documents new or updated information since ARJ 2.30.
  6.  
  7.  
  8.      ** IMPORTANT NEWS ****************************************************
  9.  
  10.         ARJ 2.39b transitions to a NEW SECURITY ENVELOPE scheme.  However,
  11.         this version WILL NOT create security envelopes.
  12.  
  13.         The previous ARJ beta, 2.39a, would not compress a few files
  14.         correctly.  You should always use the "-jt" option with ARJ
  15.         betas.
  16.  
  17.         ARJ 2.39b has improved speed in compression and decompression
  18.     over ARJ 2.30.    It uses a modification of the method 3
  19.     compressor to save memory and achieve more speed.
  20.  
  21.     The self-extractor modules have been changed significantly.  The
  22.     large ARJSFX module will NOT prompt for permission to continue
  23.     the extraction if the "-e", "-x" or "-y" arguments have been
  24.     specified. The small ARJSFXJR module will NOT count the skipping
  25.     of files that already exist as major errors.  This ARJSFXJR
  26.     skipping will generate a DOS errorlevel of 1, while other errors
  27.     will generate a DOS errorlevel of 2.
  28.  
  29.         ARJ 2.39b can NOT be register stamped.
  30.  
  31.     To prevent novices from using ARJ to update a multiple volume
  32.     archive, ARJ will not allow a multiple volume update unless the
  33.         new "-hu" option has been specified.
  34.  
  35.     The "-y" option no longers suppresses the multiple volume prompt
  36.     when the volume resides on a removable media drive such as a
  37.     diskette drive.  You can suppress the volume prompt with "-jyv".
  38.  
  39.     The processing of "-jy" and "v" switch options have improved to
  40.     be consistent with other switch processing.
  41.  
  42.     The ARJ yes/no query prompts have been changed to have a local
  43.     and a global effect.  See the USER PROMPTS section below.
  44.  
  45.     A new user prompt has been added just before asking for a new
  46.     filename during extraction when not overwriting.
  47.  
  48.     Whenever archiving to diskettes, it is HIGHLY recommended that the
  49.     option "-jt" be used.  This helps spot BAD diskettes or diskette
  50.     drives.  It is HIGHLY recommended that the "-jt" option be used in
  51.     a Windows or network environment.
  52.  
  53.     The command "ARJ e -d archive *.*" will now prompt for permission
  54.     to complete the deletion.
  55.  
  56.     Unless the "-jr" (recover) switch is used, ARJ will delete any file
  57.     extracted with a CRC or Bad file data error.
  58.  
  59.     The "m" (move) command and "-d" option will NOW delete directories
  60.     selected with the "-a1" option.
  61.  
  62.     UNERASE or UNDELETE commands do not always recover a file
  63.     correctly.  This will result in damaged archives.  This is true
  64.     for all archive types.    You should always test an archive after
  65.     unerasing it.
  66.  
  67.     If you use the software disk cache, HYPERDISK, see the KNOWN ARJ
  68.     ISSUES section in ARJ.DOC for important information.
  69.  
  70.      **********************************************************************
  71.  
  72.  
  73.      USER PROMPTS
  74.  
  75.     The ARJ user prompts have been improved to provide more
  76.     flexibility.  In addition to the normal yes and no responses, ARJ
  77.     also accepts the following responses: quit, always, skip, and
  78.     global.
  79.  
  80.     "Global" sets ARJ to inhibit all subsequent user prompts by assuming
  81.     YES for all queries as if "-y" were specified.
  82.  
  83.     The "Always" response has changed.  It now sets ARJ to assume YES
  84.     for subsequent queries of the same class.  For example, answering
  85.     YES to the overwrite query will assume YES for ALL subsequent
  86.     overwrite queries.
  87.  
  88.     "Skip" sets ARJ to assume NO for ALL subsequent queries of the same
  89.     class.
  90.  
  91.     Subsequent user prompt messages will still be output to the screen
  92.     after the "always" and "skip" responses but no user response will be
  93.     accepted.
  94.  
  95.  
  96.      ARJ ERROR LEVELS
  97.  
  98.     ARJ will now return a DOS errorlevel of 9 when trying to process
  99.     a file that is NOT an ARJ archive.
  100.  
  101.  
  102.      ARJ COMMAND LINE PROCESSING
  103.  
  104.     The option "-x-" will now ignore any previous "-xfilename" options.
  105.  
  106.  
  107.      ARJ COMMANDS
  108.  
  109.      "a" command
  110.  
  111.     When adding files that replace files in an archive, ARJ will now
  112.     display a "Replacing " message to indicate an overwrite.
  113.  
  114.  
  115.      "e" and "x" commands
  116.  
  117.         When overwriting a file, ARJ will display file size and date-time
  118.         information concerning the ARJ file and the DISK file.
  119.  
  120.  
  121.      "p" command
  122.  
  123.     When using the ARJ "p" command to redirect output to a viewer
  124.     program such as "LIST", ARJ will now set the date-time stamp of
  125.     the intermediate temporary file to the date of the archived file
  126.     as opposed to the current date and time.
  127.  
  128.  
  129.      ARJ SWITCHES
  130.  
  131.      "-d" switch
  132.  
  133.     The "-d" switch when used during extraction with the wildcard "*.*"
  134.     will prompt the user for permission to delete the files.  This
  135.     prompt can be suppressed with the "-y" or "-jyd" options.
  136.  
  137.  
  138.      "-i2" switch
  139.  
  140.     The "-i2" switch sets ARJ to display a combined percentage and
  141.     bar progress display.
  142.  
  143.  
  144.      "-m" switch
  145.  
  146.     The "-m1" and "-m2" compression methods have been modified to
  147.     improve the compression ratios.
  148.  
  149.  
  150.      "-od" switch
  151.  
  152.     The "-od" switch sets ARJ to select files no older than the
  153.     specified number of days.  The days are calculated from midnight.
  154.  
  155.     Examples:  ARJ a archive -od0     select files modified today
  156.            ARJ a archive -od1     select files modified yesterday
  157.                      and today
  158.  
  159.  
  160.      "-v" switch
  161.  
  162.     When the multiple volume ARJ files to be used are located on drives
  163.     with removable media (diskette drives, etc.), ARJ will ALWAYS
  164.     PROMPT for the next diskette even with the "-y" option specified.
  165.     You can always suppress the next volume prompt with the "-jyv"
  166.     option.  At DOS versions before 3.0, only drives A and B are
  167.     considered removable.
  168.  
  169.         ARJ will not allow the updating of multiple volume archives unless
  170.         the "-hu" option is specified.
  171.  
  172.         The "r" modifier allows the reservation of disk space on the first
  173.     volume.  The number after the "r" specifies the space to reserve.
  174.     This is useful for software installation volumes.
  175.  
  176.     Example:  ARJ a install -v360r50K   make first volume 50000 bytes
  177.                         smaller than 360K.
  178.  
  179.     Example:  ARJ u archive -v360u
  180.  
  181.     The "z" modifier works like the "s" modifier except that the system
  182.     command is NOT echoed to the screen.
  183.  
  184.     The "-v" switch now accepts its modifiers in any order.  The "s"
  185.     and "z" modifiers must be last because any succeeding text is
  186.     considered the system command to execute.
  187.  
  188.     Examples:  ARJ a volume -vavw         beep, autosize, whole files
  189.            ARJ a volume -vavsDIR     beep, autosize, execute DIR
  190.  
  191.  
  192.      "-w" switch
  193.  
  194.     When using the "-w" switch while archiving to multiple volumes, ARJ
  195.     will check the available disk space in the work directory.  If
  196.     there is not enough space, ARJ will prompt for permission to
  197.     continue.  This prompt can be suppressed with the "-y" and "-jyd"
  198.     switches.
  199.  
  200.  
  201.      "-y" switch
  202.  
  203.     The "-y" switch will no longer suppress the "-v" next volume prompt
  204.     when the archive is located on a drive with removable media such as
  205.     a diskette drive.
  206.  
  207.  
  208.      "-ja1" switch
  209.  
  210.     The "-ja1" switch will suppress the display of the archive comment.
  211.  
  212.  
  213.      "-jn" switch
  214.  
  215.     The "-jn" switch is used to restart a multiple volume archive.    The
  216.         index file created by the "-ji" switch at ARJ 2.39b can be used to
  217.     facilitate restarting.    Please note that index files created by
  218.     older versions of ARJ will not work with this restart method.  This
  219.     method uses the "-jn" syntax without a filename.  The previously
  220.     written index file is scanned to determine the restart information.
  221.  
  222.     To use this method of restarting, you must specify the "-ji" switch
  223.     to build an index file while archiving to multiple volumes.  To
  224.     restart an interrupted sequence, simply specify the EXACT SAME
  225.     command line as before and add "-jn".  ARJ will determine the
  226.     archive name, the restart filename, and the restart file position.
  227.  
  228.     Example:  ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL
  229.           ARJ a a:volume -va c:\*.* -r -jiINDEX.FIL -jn
  230.  
  231.  
  232.      "-jp" switch
  233.  
  234.     The "-jp" switch will be ignored if the ARJ output has been
  235.     redirected as in "ARJ l archive -jp > dump".
  236.  
  237.  
  238.      "-jr" switch
  239.  
  240.     The "end of file" error message will no longer be displayed when
  241.     using the "-jr" option on a valid ARJ archive.
  242.  
  243.  
  244.      "-jy" switch
  245.  
  246.     The "-jy" switch options are now parsed like other switches with
  247.     regard to toggling and the "+/-" modifiers.  You can also specify
  248.     multiple occurrences of the "-jy" options.
  249.  
  250.     Examples:  -jyo -jyo    evaluates to no change
  251.            -jyo -jyo+    evaluates to suppress overwrite prompt
  252.            -jyo+c+y+    evaluates to suppress overwrite and create
  253.                 prompts and use single key input mode
  254.  
  255.  
  256.      "-ha" switch
  257.  
  258.     The "-ha" switch sets ARJ to reset the attributes of a file to be
  259.     overwritten or a file to be deleted.  This allows the overwrite or
  260.     delete operation to proceed.
  261.  
  262.     A slight performance degradation may result from using this option.
  263.  
  264.     Examples:  ARJ e archive -ha
  265.            ARJ m archive -ha dir\*.*
  266.  
  267.  
  268.      "-hc" switch
  269.  
  270.     The "-hc" switch sets ARJ to execute a DOS command at the start of
  271.     the execution of ARJ immediately after the command line switch
  272.     options have been processed, but before the wildcard search is
  273.     started.  This can be used to clear the screen to hide the command
  274.     line or to provide a pause option to allow swapping diskettes.
  275.  
  276.     Examples:  ARJ a -hcCLS archive -gpassword
  277.            ARJ a -hcPAUSE archive *.*
  278.  
  279.  
  280.      "-he" switch
  281.  
  282.     The "-he" switch sets ARJ to abort with an error code of 4 when
  283.     processing a possibly ARJ-SECURED archive.  This is useful as a
  284.     REARJ.CFG option for ARJ.  This will prevent REARJ from converting
  285.     an ARJ-SECURED archive to the same or another format.
  286.  
  287.     Examples:  ARJ l secured.arj -he
  288.  
  289.  
  290.      "-hi" switch
  291.  
  292.     The "-hi" switch when used with the "-ji" switch sets ARJ to
  293.     include the file date-time stamp, the original file size, the
  294.     compressed file size, the compression ratio, and the filename in
  295.     the index file.
  296.  
  297.     Example:  ARJ a a:backup c:\*.* -r -va -jiINDEX -hi
  298.  
  299.  
  300.      "-hs" switch
  301.  
  302.     The "-hs" switch sets ARJ to disable its file sharing support.
  303.     This may be necessary for some unusual applications.
  304.  
  305.  
  306.      "-hu" switch
  307.  
  308.         The "-hu" switch sets ARJ to allow the updating of multiple volume
  309.         archives.  At this revision, by default, ARJ does not allow
  310.         updating of multiple volume archives because of the possibility of
  311.         losing data.
  312.  
  313.         Example:  ARJ c archive -hu -zcomment.txt
  314.  
  315.  
  316.      "-hw" switch
  317.  
  318.     The "-hw" switch sets the ARJ w command to display the
  319.     "Searching ..." filenames messages in a scroll saving format.
  320.     Filenames of files that do not contain string matches will be
  321.     overwritten on the screen.
  322.  
  323.     The "-hw1" switch sets the ARJ w command to ONLY display the
  324.     "Searching ..." filenames messages for files that contain string
  325.     messages.
  326.  
  327.  
  328.      end document
  329.  
  330.